home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-04 / dvue11.zip / DV.DOC < prev    next >
Text File  |  1993-04-13  |  65KB  |  1,618 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.                                  DOSview (tm)
  23.  
  24.                               "A DOS Extension"
  25.  
  26.  
  27.  
  28.  
  29.                       Written and (C)Copyright 1992-1993
  30.  
  31.                                       by
  32.  
  33.                                  Skip Bremer
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.                                  Version 1.10
  42.  
  43.                                    4/13/93
  44.  
  45.                               TABLE OF CONTENTS
  46.  ==============================================================================
  47.  
  48.      Topic                                                          Section
  49.      -----                                                          -------
  50.  
  51.      Introduction ......................................................  1
  52.  
  53.      Miscellaneous .....................................................  2
  54.           Requirements
  55.           Limits
  56.           Startup Options
  57.           Startup Warnings
  58.           Renaming DOSview
  59.           Stopping Commands
  60.  
  61.      Files .............................................................  3
  62.           Required
  63.           Supporting
  64.  
  65.      Commands ..........................................................  4
  66.           General
  67.           Normal Function Keys
  68.           Alternate Function Keys
  69.           Shift Function Keys
  70.           Control Function Keys
  71.           Miscellaneous Keys
  72.  
  73.      DOSview Menu ......................................................  5
  74.  
  75.      Swapping ..........................................................  6
  76.  
  77.      Setup .............................................................  7
  78.           Normal Defaults
  79.           Viewing Defaults
  80.           Notes
  81.  
  82.      Editor ............................................................  8
  83.           Internal Editor
  84.           Internal Viewer
  85.  
  86.      Panel Mode ........................................................  9
  87.           Wide Mode
  88.           Snake Mode
  89.           Command Line
  90.  
  91.      DOS Mode .......................................................... 10
  92.           Normal Function Keys
  93.           Control Function Keys
  94.           Miscellaneous Keys
  95.           Command Line
  96.  
  97.      Tree Mode ......................................................... 11
  98.           Function Keys
  99.           Command Line
  100.           Notes
  101.  
  102.      DOS Menu Mode ..................................................... 12
  103.           Function Keys
  104.           Notes
  105.  
  106.      Tagging ........................................................... 13
  107.  
  108.      Batch Mode ........................................................ 14
  109.  
  110.      Network Operation ................................................. 15
  111.  
  112.      Credits ........................................................... 16
  113.  
  114.      Shareware ......................................................... 17
  115.           Shareware
  116.           Distribution
  117.           Registration
  118.           Disclaimer
  119.  
  120.                                  INTRODUCTION (1)
  121.  ==============================================================================
  122.  
  123. DOSview (tm) was designed to be a shell for MS-DOS (tm) that meets the real
  124. needs of computer professionals (and to some extent, casual users alike).
  125. Whenever we faced a choice between enhancing the program's usefulness as a
  126. true programming tool as opposed to simply a DOS helper, the programming tool
  127. choice won out.  This is because we work in an environment that demands a
  128. quick, useful tool to help us do our job.  We support a large Netware 386 (tm)
  129. wide area network domain spanning Texas.  Our environment demands a tool that
  130. is always available with a useful and powerful command set to ease our job and
  131. thereby help us to support our users in a more professional manner.  Quite
  132. simply, DOSview, more than any other single product we know of, does just
  133. that.
  134.  
  135. There are many other shells available to the professional for the asking, and
  136. we have access to nearly all of them.  With the exception of Norton Commander
  137. (tm), however, we know of no shell that comes close to meeting our needs.  As
  138. such, it should become obvious to you that DOSview was initially patterned
  139. after Norton Commander.  It's always-available command line and dual-directory
  140. panel displays have become famous to those who do serious DOS-level work.
  141.  
  142. After using Norton Commander for some time, many full-time users become aware
  143. of certain capabilities that are missing from an otherwise outstanding
  144. package.  We believe the Norton Commander programmers did a fantastic job in
  145. their own right, and as much as DOSview tries to build on their program, some
  146. items are still only available in the Norton Commander package.
  147.  
  148. Nevertheless, we have found that DOSview's tool set make it an even more
  149. practical approach to DOS-level work.  If you agree, then you are probably
  150. getting your job done better, as we are.  Please use DOSview as you see fit,
  151. but if you continue to use it, please abide with the Shareware section of this
  152. documentation.
  153.  
  154. This documentation is minimal.  It explains what is available in DOSview and
  155. how to use its features.  It is by no means a tutorial on anything.  If you do
  156. not know DOS (or networking, if you are in such an environment) then DOSview
  157. will, on its own, still make your life easier.  If you do have a reasonable
  158. understanding of DOS (and, where applicable, networking) then DOSview will
  159. expand your capabilities by providing you with many of the "necessities" you
  160. normally reach for in a multitude of other packages and separate tools.
  161.  
  162. Please note that DOSview was also coded in a "minimal" fashion.  By that we
  163. mean that when the choice came between a more robust interface and a sparse
  164. command that was simply strong and to-the-point (perhaps lacking in the user
  165. interface area), we always chose the latter.  One of our overriding goals in
  166. writing DOSview was to keep it as small and quick as possible -- at all costs
  167. (the menu system is an exception).  There are many things that we put into
  168. DOSview and then took back out again as we tried to balance its size against
  169. its functionality.  We are not unhappy with the overall result.  We hope it
  170. will satisfy you as well.  We wrote the code in Borland's Turbo Pascal (tm)
  171. 7.0 (real mode) with assembly code where needed.  DOSview is actually faster
  172. than Norton Commander in some areas, while slightly slower in others.
  173.  
  174.                                 MISCELLANEOUS (2)
  175.  ==============================================================================
  176.  
  177. Requirements
  178. ------------
  179. DOSview's only requirement is that it must run under DOS 3.1 or higher.
  180.  
  181.  
  182. Limits
  183. ------
  184. Maximum files in each panel: 2175 files
  185. Maximum directories in the directory tree (Tree Mode): 2325 directories
  186. Maximum size of file in the internal editor: 65519 bytes (63.99 kbytes)
  187.  
  188.  
  189. Startup Options
  190. ---------------
  191. Normally DOSview is started by typing DV (or whatever you have decided to
  192. call it).  However, DOSview does have one useful startup option:  you can
  193. specify what drive each of the two DOSview panels uses as their initial
  194. domain.  For example, starting DOSview with the command  DV C F  will start
  195. DOSview and then attempt to point the current panel to drive C and its current
  196. directory and the other panel to drive F and its current directory.  If you
  197. had typed DV only, then DOSview would have pointed the current panel to the
  198. current drive (and directory) and the other panel to the root of the current
  199. drive.
  200.  
  201.  
  202. Startup Warnings
  203. ----------------
  204. When starting DOSview, it checks to see it the help file (normally DV.HLP) is
  205. available.  If not, DOSview will issue a warning message to you on the startup
  206. DOS screen.  DOSview also checks all of the defined external viewers, editors
  207. and programs found in the INI file, and similarly reports to you any of those
  208. files that cannot be found.  If you get one of these messages, you should
  209. correct the problem by either copying DV.HLP to DV.EXE's home directory or
  210. going to setup and redefining the offending external programs.
  211.  
  212.  
  213. Renaming DOSview
  214. ----------------
  215. For your convenience, especially in a shared network environment, you may
  216. rename DOSview is you wish.  If you do, then all of the supporting files
  217. DOSview uses and makes must be and will be renamed along with it.  You only
  218. need to rename DV.EXE and DV.HLP to another name, like MY.EXE and MY.HLP.
  219. DOSview will take care of renaming the INI, TRE and MNU files accordingly.
  220.  
  221.  
  222. Stopping Commands
  223. -----------------
  224. Some commands are very powerful, particularly XCOPY, YMOVE and WIPE; some
  225. copy, move, and erase commands.  If you find you have made a mistake while
  226. performing a lengthy command, press Esc.  The next opportunity DOSview has to
  227. stop it will ask you if you wish to stop the current process.  Answer Yes to
  228. halt the current process.  Remember, however, that it will only stop the
  229. command; it will _not_ reverse any actions that have already taken place.
  230.  
  231.                                     FILES (3)
  232.  ==============================================================================
  233.  
  234. Required
  235. --------
  236. The following files are necessary to run DOSview:
  237.  
  238. DV.EXE    The main program.  It can be renamed.
  239.  
  240. DV.HLP    The help file.  If DV.EXE is renamed, then this file must be
  241.           renamed also.  This file must reside in DV.EXE's home directory.
  242.           That is, if DV.EXE is in C:\TOOLS, then DV.HLP must be there also
  243.           (or you won't get help).
  244.  
  245.  
  246. Supporting
  247. ----------
  248. The following files are made by DOSview:
  249.  
  250. DV.INI    The setup file.  This file is placed into DV.EXE's home directory
  251.           when you save the setup options screen or quick save panel setups
  252.           with ^F10.  If DV.EXE is renamed, then this file will automatically
  253.           be renamed upon creation.
  254.  
  255. DV.MNU    The menu file.  This file is placed into DV.EXE's home directory
  256.           when you edit and save a menu specification.  If DV.EXE is renamed,
  257.           then this file will automatically be renamed upon creation.
  258.  
  259. DV.TRE    The tree file.  This file be placed into the root of DV.EXE's home
  260.           drive when you build a tree.  If DV.EXE is renamed, then this file
  261.           will automatically be renamed upon creation.
  262.  
  263.                                    COMMANDS (4)
  264.  ==============================================================================
  265.  
  266. General
  267. -------
  268. DOSview is mostly function key driven.  There is an alternate menu system that
  269. is especially useful for getting to know DOSview.  But for quick work, we find
  270. the function key set most useful.  For that reason, the function key line at
  271. the bottom of the panel windows is "live".  In other words, whatever state the
  272. keyboard is in, this line reflects it by showing the proper function key set.
  273.  
  274. For example, if you hold the Ctrl key down, then DOSview shows you the control
  275. function keys.  If only one panel is displayed, the function key line is half
  276. size but still helpful.  Additionally, a quick F1 press will always show all
  277. of the function keys and shortcut keys on one compact screen.  Note that
  278. function key commands are also dimmed when their commands are not applicable.
  279.  
  280. Many of the most commonly used commands have a shortcut key.  Most shortcut
  281. keys are control keys.  For example, pressing ^O (which is the same as F2)
  282. will toggle between Panel Mode and DOS Mode.  Some shortcut keys are normal
  283. keyboard keys, like '/' for Tree Mode, and only work when the command line
  284. cursor is at the beginning of the command line.  All shortcut keys are listed
  285. as part of the discussion of their normal function key equivalents below and
  286. on DOSview's pull down menu windows.
  287.  
  288.  
  289. Normal Function Keys
  290. --------------------
  291. F1   HELP      DOSview contains context sensitive help.  Anytime you are about
  292.                to commit to a command, you may press F1 to learn more about
  293.                it.  Some commands take place immediately, and you will need to
  294.                consult this documentation for them.
  295.  
  296. F2   PANES     Toggles between panels, or a single panel, (Panel Mode) display
  297.                and a no panels display (DOS Mode).  You have instant access to
  298.                DOS in either Panel Mode or DOS Mode, but DOS Mode is sometimes
  299.                more convenient.  See the Panel Mode and DOS Mode appendices
  300.                for a further explanation of these modes.  (Shortcut key = ^O)
  301.  
  302. F3   VIEW      Views the highlighted file.  See the Setup section for more on
  303.                viewing.
  304.  
  305. F4   EDIT      Edits the highlighted file.  See the Setup section for more on
  306.                editing.
  307.  
  308. F5   COPY      Copies the highlighted file or a group of tagged files.  The
  309.                default target is the other panel's domain, or if both panels
  310.                are the same, nothing.  It is important to note that all copy
  311.                and move sequences carried out by DOSview _always_ carry the
  312.                source file's attributes to the target copy of the file.  This
  313.                is what we call an "exact copy".  You always get exactly what
  314.                you had (not true with DOS).  When copying over readonly files,
  315.                you will be asked to confirm each copy.  When copying over
  316.                files that already exist, you will be asked to confirm.  In
  317.                this case you may answer O)verwrite to overwrite that one file
  318.                or A)ll to overwrite that one file and any others that may come
  319.                up (if copying multiple files).
  320.  
  321. F6   REN       Moves the highlighted file or a group of tagged files or
  322. -or- MOVE      renames one file or directory.  If moving, the default target
  323. -or- RENMV     will be the other panel's domain, or if both panels are the
  324.                same, nothing.  If renaming, the default is the current name.
  325.                It is important to note that all copy and move sequences
  326.                carried out by DOSview _always_ carry the source file's
  327.                attributes to the target copy of the file.  This is what we
  328.                call an "exact copy".  You always get exactly what you had (not
  329.                true with DOS).  When moving to files that already exist, you
  330.                will be asked to confirm.  In this case you may answer
  331.                O)verwrite to overwrite that one file or A)ll to overwrite that
  332.                one file and any others that may come up (if moving multiple
  333.                files).
  334.  
  335. F7   MKDIR     This command makes a directory that you name within the current
  336.                panel's domain.
  337.  
  338. F8   ERASE     Erases the highlighted file or a group of tagged files.  When
  339.                erasing groups of files, you will be asked to confirm the
  340.                erasures.  When erasing readonly files, you will be asked to
  341.                confirm each readonly file.  This command will also remove
  342.                empty directories.
  343. -or-
  344. F8   WIPE      When you press F8 on a directory name that contains additional
  345.                files and/or directories below it, you will be asked twice if
  346.                you wish to remove the underlying structure.  If you answer
  347.                Yes, _all_ structure below the directory you are pointing at
  348.                will be deleted, no matter what the attributes of files within
  349.                that structure are.  This is a quick and final "wipe" of the
  350.                entire directory structure.  Be careful!  The deletions are
  351.                actually a combination of file deletes and directory removes,
  352.                nothing cosmic.  But the effect is a thorough bulk cleaning of
  353.                the structure - all at once.  (Most unerase tools can bring
  354.                back the files deleted with this command).
  355.  
  356. F9   MENU      Brings up the DOSview menu system, an alternate to this
  357.                function key command set interface.  Once you learn the
  358.                function keys (and shortcut keys) you will find that they are
  359.                faster for getting the job done.
  360.  
  361. F10  QUIT      Use this command to quit DOSview (from either Panel Mode or DOS
  362.                Mode).  You will be asked to confirm.
  363.  
  364.  
  365. Alternate Function Keys
  366. -----------------------
  367. F1   DRIVE <   Allows you to choose another drive for the left panel.  Only
  368.                on-line drives are shown.  You can always simply type a drive
  369.                letter and a colon and press Enter at the command line for the
  370.                current panel, as well.
  371.  
  372. F2   DRIVE >   Just like DRIVE < except this command is for the right panel.
  373.  
  374. F3   VIEW2     An alternate way of viewing the highlighted file.  See the
  375.                Setup section for more on viewing.
  376.  
  377. F4   EDIT      An alternate way of editing the highlighted file.  See the
  378.                Setup section for more on editing.
  379.  
  380. F5   XCOPY     This command copies the entire highlighted directory and all of
  381.                the structure below it to the other panel's domain.  As with
  382.                all copy commands, all of the attributes are carried with all
  383.                of the files (but not non-dos like network attributes), so you
  384.                get an exact DOS-level file keeping all file attributes
  385.                intact.  You will be asked to confirm.  This is called pruning
  386.                and grafting by some other utilities.
  387.  
  388. F6   YMOVE     This command is just like the XCOPY command except that a move
  389.                is performed instead of a copy.  Again, it is called pruning
  390.                and grafting in some other utilities.
  391.  
  392. F7   FIND      Allows you to search for any file or file specification within
  393.                the current panel's domain.  The file specification should only
  394.                have trailing wild cards in the filename or the file extension,
  395.                like:  DV.*.  After finding a file, you have the choice of
  396.                continuing the search or "going" directly to the found file.
  397.                Going means that DOSview will change directories and then point
  398.                to the found file.  (Shortcut key = ^Z)
  399.  
  400. F8   TOTAL     Totals all of the files in the underlying structure of the
  401.                highlighted directory and then displays the total in the same
  402.                place individual file totals are shown.  
  403.  
  404. F9   LINES     Switches the display from normal 25 line mode to 43/50 line
  405.                EGA/VGA mode (if so equipped) and back.
  406.  
  407. F10  DATA      Controls what data is displayed for each file in the current
  408.                panel.  See Panel Mode and DOS mode appendices for more on this
  409.                subject.  (Shortcut key = ^D)
  410.  
  411.                The default is:
  412.  
  413.                FILENAME  EXT  SIZE (in Bytes)   DATE  TIME.
  414.  
  415.                The alternative is
  416.  
  417.                FILENAME  EXT  SIZE (in KBytes)  DATE  ATTRIBUTES.
  418.  
  419.  
  420. Shift Function Keys
  421. -------------------
  422. F1   SORT <    Sorts the left panel's files by one of the following choices:
  423.  
  424.                FILENAME  EXT  SIZE  DATE&TIME  ATTRIBUTES
  425.  
  426.                The shortcut key ^S conveniently switches back and forth
  427.                between filename and extension sorts in the current panel.
  428.  
  429. F2   SORT >    Sorts the right panel's files by one of the following choices:
  430.  
  431.                FILENAME  EXT  SIZE  DATE&TIME  ATTRIBUTES
  432.  
  433.                The shortcut key ^S conveniently switches back and forth
  434.                between filename and extension sorts in the current panel.
  435.  
  436. F3   VIEW1     Another way to view the highlighted file.  See the Setup
  437.                section for more on viewing.
  438.  
  439. F4   EDIT?     Allows editing of a new file or any file on the system.  See
  440.                the Setup section for more on editing.
  441.  
  442. F5   ATTR      Allows you to change one of the attributes for the highlighted
  443.                file or all tagged files in the current panel.  Note that
  444.                directory attributes, though shown, cannot be changed.  A
  445.                network directory's hidden attribute must be changed using a
  446.                network utility.  (Shortcut key = ^A)
  447.  
  448. F6   GHOST     In Snake Mode, DOSview normally shows all files and directories
  449.                having a hidden attribute in a soft color (a "ghost" color).
  450.                You can toggle this trait to show all files with a readonly
  451.                attribute instead.  This is great for network management.
  452.                (Shortcut key = ^G)
  453.  
  454. F7   FILTER    Allows you to filter what files are displayed in the current
  455.                panel.  You provide an extension and only those files will be
  456.                shown.  The extension can be less than three characters, but
  457.                _no_ wild cards may be used.  For example, TXT and SC are ok,
  458.                but SC?  is not.  (Shortcut key = ^F)
  459.  
  460. F8   BATCH     Allows you to write on-the-fly batch files or text files based
  461.                on tagged files in the current panel.  See the Batch Mode
  462.                section for more on Batch Mode Operations.  (Shortcut key = ^B)
  463.  
  464. F9   HEIGHT    Toggles the panel heights of both panels from short to tall and
  465.                back.  Combined with a 50-line screen and Snake Mode, you can
  466.                see a lot of files at once!  (135 total files versus 78 files
  467.                in short mode)  (Shortcut key = ^Q)
  468.  
  469. F10  SETUP     The main way to set up DOSview's defaults and other items.  See
  470.                the large section on Setup for a full description.
  471.  
  472.  
  473. Control Function Keys
  474. ---------------------
  475. F1   PANEL <   Turns the left panel on or off.  (Also ^P or ShiftTab)
  476.  
  477. F2   PANEL >   Turns the right panel on or off.  (Also ^P or ShiftTab)
  478.  
  479. F3   VIEWER    Turns the other panel into a quick viewer.  Works great for text
  480.                files.  Press F3 or F4 (etc) to enhance this mode on any
  481.                particular file.  (Shortcut key = ^V)
  482.  
  483. F4   EDITL     Edits the last file edited with the last editor used (internal
  484.                or external), no matter where you are on your system.
  485.  
  486. F5   STATS     Shows the complete memory and disk stats for the host machine.
  487.                All memory types are shown.  The total disk space will be
  488.                inaccurate if you are spanning drives on a network.  (Shortcut
  489.                key = ^L)
  490.  
  491. F6   COMP      Highlights files in both panels newer than the same file in the
  492.                other panel.  If a file does not exist in the other panel, it
  493.                will also be highlighted.  ^K finds duplicate files by name
  494.                only.  (Shortcut key = ^C {compare} or ^K {duplicates})
  495.  
  496. F7   SWAP      Swaps both panel's domains.  What was previously displayed in
  497.                the right panel is now in the left panel and vice versa.  The
  498.                Snake/Wide Modes are not swapped, however.  If only one panel
  499.                is being displayed, then this command will bring the other
  500.                panel's domain into the current panel, and vice versa.
  501.                (Shortcut key = ^U)
  502.  
  503. F8   RESCAN    Refreshes the current panel (not often needed).  (Shortcut key
  504.                = ^R)
  505.  
  506. F9   WIDTH     Toggles the current panel between Wide Mode and Snake Mode.
  507.                See the Panel Mode section for more about these two modes.
  508.                (Shortcut key  =^W)
  509.  
  510. F10  SAVE      Saves both panel's states.  A list of what is saved can be
  511.                found in the Setup section (which also saves panel states).
  512.  
  513.  
  514. Miscellaneous Keys
  515. ------------------
  516. ENTER          Runs the highlighted program or changes to the highlighted
  517.                directory.  If not on an EXE, COM or BAT file and not on a
  518.                directory, then views the current file.  See the Setup section
  519.                for more on viewing.  (Also ^M)
  520.  
  521. ^ENTER         Copies the current file or directory name to the DOS command
  522.                line.  (Also ^J)
  523.  
  524. TAB            Moves from the current panel to the other.  If the other panel
  525.                is not active (not visible), then TAB moves the other panel's
  526.                domain into the current panel, and vice versa (just like SWAP).
  527.                (Also ^I)
  528.  
  529. INS            Tags or untags the current file and moves to the next file.
  530.  
  531. ^\             A quick way to get to the root directory.  Of course, you may
  532.                also type CD\ at DOSview's DOS prompt.
  533.  
  534. /              DOSview provides a complete hard disk tree facility for quickly
  535.                moving to a particular directory (great for networks).  See the
  536.                Tree Mode section for more.  (The DOS command line must be
  537.                empty to perform this command.)
  538.  
  539. =              DOSview provides a built in menu for DOS commands that is
  540.                completely definable by you.  See the Menu Mode section for
  541.                more.  (The DOS command line must be empty to perform this
  542.                command.)
  543.  
  544. +/-            Tags or untags groups of files,  the specification you give
  545.                will act exactly like the normal DOS * and ?  specifications.
  546.                When there are a lot of files in the current directory, this
  547.                process can take a few seconds because it rereads the directory
  548.                to get an exact match.  (The DOS command line must be empty to
  549.                perform this command.)
  550.  
  551. *              After tagging a set of files (through a panel COMPARE command
  552.                for example), this command allows you to immediately reverse
  553.                all of the attributes in the current panel.  (The DOS command
  554.                line must be empty to perform this command.)
  555.  
  556. AltA..Z,       Moves the highlight cursor to the next file starting with the
  557. Alt0..9, Alt-  character you pressed.  To continue the search, continue
  558.                pressing letters.  Any letters pressed after the first one do
  559.                not have to be Alt characters.
  560.  
  561.                                  DOSVIEW MENU (5)
  562.  =============================================================================
  563.  
  564. DOSview employs a menu system as an alternative interface provides an
  565. intuitive way for new users to learn the somewhat extensive function key
  566. interface.
  567.  
  568. Each menu item shows its corresponding function key command in order to help
  569. you learn the function key set.
  570.  
  571. Dimmed items on the menus are not available because of the current panel
  572. states (tagged or untagged files, highligting a file or directory, etc.).
  573.  
  574. You may either use the Arrow Keys to move to an item and press Enter or simply
  575. press the highlighted character for the choice you wish to run.
  576.  
  577.                                    SWAPPING (6)
  578.  ==============================================================================
  579.  
  580. DOSview employs a swap algorithm in order to provide a reasonable amount of
  581. memory for DOS applications that are run from DOSview (either from the command
  582. line, point and shoot, or from the DOS menu).  DOSview takes about 7K of
  583. memory away from applications to remember its shell duties.  This amount
  584. includes the approximate 3K overhead used by DOS.
  585.  
  586. DOSview gives an abundance of choices on where you would like to have it swap:
  587.  
  588. o    Extended memory controlled by HIMEM.SYS, QEMM.SYS, 386MAX.SYS, etc (XMS).
  589.  
  590. o    Expanded memory version 4.0 (EMS).
  591.  
  592. o    Hard disk (local or network).
  593.  
  594. o    RAMdrive defined in EMS memory (/E).
  595.  
  596. o    RAMdrive defined in XMS memory (/A).
  597.  
  598. You choose which way you want to go with the setup function.  See the Setup
  599. section for more.
  600.  
  601. If you allow DOSview to swap anywhere, it will try to swap in this order:
  602. EMS, XMS, and then the root of the drive you specified.  You have the
  603. flexibility in setup to disallow any of the two memory swapping options.
  604. Additionally, you may specify the drive that DOSview will use if it can't swap
  605. to memory.
  606.  
  607. We like to default DOSview to look for both EMS and XMS and then, if needed,
  608. swap to a privately mapped drive letter on the network (that we all have).
  609. Your needs may dictate that you negate one or both of the memory options
  610. depending upon what applications you are running.
  611.  
  612. DOSview has no problems running in a DOS window under Windows 3.1.  You can
  613. even run Windows _from_ DOSview if you feel a quick need.
  614.  
  615. When running on a network, you should keep the following in mind:  Do not try
  616. to run batch files that have mapping commands in them.  The maps will be for a
  617. child DOS process and the program you are trying to run will not run.  This is
  618. true of any shell program.
  619.  
  620. Of course, whether on a network or not, do not run memory resident software
  621. from DOSview.  This also is true of any shell program.
  622.  
  623. If DOSview cannot find a place to swap, then it will put a message under the
  624. DOS prompt before it runs the program to remind you of such.  You should
  625. correct the problem if this occurs because a lot of memory is used in this
  626. case.  The message is:  (unable to swap).
  627.  
  628. CONFIG.SYS DOS command to provide XMS swapping memory:
  629.      DEVICE=HIMEM.SYS (or QEMM..  or 386MAX.., etc) {If you are not running
  630.        HIMEM.SYS - you probably ought to be...}
  631.  
  632. CONFIG.SYS DOS commands to provide EMS swapping memory:
  633.      DEVICE=HIMEM.SYS
  634.      DEVICE=EMM386.EXE 160 RAM
  635.  
  636. CONFIG.SYS DOS commands to provide a RAMdrive swapping drive:
  637.      DEVICE=HIMEM.SYS
  638.      DEVICE=RAMDRIVE.SYS 160 /E -or- /A
  639.      The /E is for XMS (extended) and the /A is for EMS (expanded).  You
  640.      should make sure your RAMdrive has at least 160,768 bytes available for
  641.      the swap.  RAMDRIVE.SYS will take a little bit when creating the 160K
  642.      (143,840 bytes) drive.
  643.  
  644. Don't be confused!  Normally only DEVICE=HIMEM.SYS is needed to perform memory
  645. swapping.
  646.  
  647. Note that the shareware version of DOSview swaps a little more code than the
  648. registered version.  The above figures are for the registered version.
  649.  
  650. It should be noted that when viewing programs with the F3 key, or editing
  651. files with the F4 key, those external programs run without any swapping in
  652. order to provide super-fast viewing capability.  See the Setup section for
  653. more.
  654.  
  655.                                     SETUP (7)
  656.  ==============================================================================
  657.  
  658. The setup facility is accessed with the ShiftF10 key and is the main way you
  659. configure DOSview to work the way you want it to work.  This discussion will
  660. talk about the setup items as they appear on the setup screen.  The Tab and
  661. ShiftTab keys will quickly move around the Setup Mode screen.  Then use the
  662. Down and Up arrow keys.  Ins toggles insert/overtype.
  663.  
  664.  
  665. NORMAL DEFAULTS
  666. ===============
  667.  
  668.  
  669. Swap Drive
  670. ----------
  671. This is where you tell DOSview what drive to use for its swapping algorithm.
  672. You can only enter any drive letter that exists on your system except floppys.
  673. It will only swap to the root of this drive if the next two memory swapping
  674. choices are both turned off or if DOSview cannot find any EMS or XMS memory to
  675. swap to.  On a network, we recommend that this drive be a privately mapped
  676. drive letter that is unique for each user.  See the Swapping section for more.
  677.  
  678. Novell example:  MAP ROOT H:=SYS:USERS\%LOGIN_NAME
  679.  
  680.  
  681. Allow EMS Swaps
  682. ---------------
  683. If Yes, then this is always the first place DOSview looks to swap to.  160K of
  684. EMS will be used for the swap (10 16K pages).  See the Swapping section for
  685. more.
  686.  
  687.  
  688. Allow XMS Swaps
  689. ---------------
  690. If Yes, then this is always the second place DOSview looks to swap to.  It
  691. will swap to EMS first if available and you have that option turned on.  If
  692. swapping to XMS, then a little less then 160K will be allocated to DOSview for
  693. the swap.  See the Swapping section for more.
  694.  
  695.  
  696. Color Set
  697. ---------
  698. You choose the color set you wish DOSview to use here.  This only affects the
  699. actual color schemes, not the video memory addresses (it figures that out all
  700. by itself).
  701.  
  702.  
  703. Show File Colors
  704. ----------------
  705. If Yes, then DOSview will show certain file extensions in color (see the A B
  706. C D ..  section below) and will show either hidden or readonly files in a
  707. "ghost" color.
  708.  
  709.  
  710. Show Volume Label
  711. -----------------
  712. If Yes, then DOSview will show the drive or volume's volume label just before
  713. the current directory at the top of each panel.  This can be especially nice
  714. for networks with more than one volume.
  715.  
  716.  
  717. F4-Internal Editor
  718. ----------------------
  719. This determines whether the internal or external editor is called when you
  720. press F4.  The other editor will run when you press AltF3.
  721.  
  722.  
  723. User Name for Net Prompt
  724. ------------------------
  725. The name to be shown in the DOSview prompt when on a network.  See the Network
  726. Operations section.
  727.  
  728.  
  729. A B C D .. (File Colors)
  730. ----------
  731. This portion of the setup screen is where you may define different display
  732. colors for certain file types.  For example, enter 'EXE' and 'E' to show
  733. executable files on bright white on a color system.  Trailing wild cards only
  734. are allowed here.  Examples:
  735.  
  736. TXT
  737. TX
  738. TX*
  739. T*
  740.  
  741.  
  742. VIEWING DEFAULTS
  743. ================
  744.  
  745. The following setup choices define how DOSview will interact with your files
  746. when viewing and editing them.  In all cases, either the complete path name of
  747. the program or a shortcut defined as '&' before the program name is required.
  748. '&' means the program's path is the same as DV.EXE's home directory.  This is
  749. convenient when you wish to move DOSview around along with your defined
  750. support viewers.  The complete path (or '&') is needed to ensure that DOSview
  751. run the viewing program as quickly as possible (without DOS search support)
  752. for better integration.  The file extension must also be included. Examples:
  753.  
  754.      c:\dos\edit.com
  755.      &edit.com (with DV.EXE being in the same directory as EDIT.COM)
  756.  
  757.  
  758. External Viewer1
  759. ----------------
  760. This program will normally call the highlighted file whenever you press F3,
  761. unless you have defined an 'ext' program for the highlighted file type.  Even
  762. if you have defined an 'ext' program, pressing ^F3 will force this program to
  763. run anyway, bypassing the 'ext' program.
  764.  
  765.  
  766. External Viewer2
  767. ----------------
  768. This program will call the highlighted file whenever you press AltF3, no
  769. matter what else is defined.
  770.  
  771.  
  772. External Editor
  773. ---------------
  774. Even though DOSview has a reasonable internal editor, you may wish to use your
  775. own.  You define that program here.
  776.  
  777.  
  778. 'Ext' Programs
  779. --------------
  780. In addition to the viewing choices above, you may define specific 'ext'
  781. programs for various file types here.  They will run when F3 (or Enter for a
  782. few) is pressed.  To bypass one of these viewers for the External Viewer1,
  783. press ^F3 instead. Trailing wild cards are allowed here.  Examples:
  784.  
  785. ZIP  &pkzip.exe -vbmn
  786. WK*  c:\lotus\123.exe
  787. W*   &123.exe
  788.  
  789. If you pressed Enter on an 'ext' program file type, but one was not defined,
  790. then DOSview will look for an F3 'ext' program and then for External Viewer1.
  791. The main difference between these 'ext' programs is that DOSview gives you the
  792. swapping choice for each program (viewer1/2 and the external editor do not
  793. swap in oder to maintain speed).  Some 'ext' programs require swapping due to
  794. their internal memory requirements.
  795.  
  796.  
  797. Here is something we use these 'ext' program categories (F3 and Enter) for:
  798.  
  799. Ext S 'Ext' Programs (F3)
  800. ZIP Y &zv.exe - our third party program that show a pick list of zip files for
  801. further viewing without actually unzipping zip file.
  802.  
  803.                      (Enter)
  804. ZIP N &pkzip.exe -vbmn - simply lists the zip file names to the screen.
  805.  
  806.  
  807. NOTES
  808. =====
  809.  
  810. Do not define EXE, COM or BAT files.  DOSview already knows exactly what to do
  811. with them.
  812.  
  813. When you press F2 to save your setup choices, the states of the two directory
  814. panels are also saved.  The same items are saved whenever you press ^F10
  815. (SAVE) from a panel.  The saved panel items are:
  816.  
  817.      Active panel (Tab)
  818.      Other panel visibility (^F9)
  819.      Panels height (ShiftF9)
  820.      Left panel Wide/Snake Mode (F9)
  821.      Right panel Wide/Snake Mode (F9)
  822.      Left panel sort key type (ShiftF1)
  823.      Right panel sort key type (ShiftF2)
  824.      Left panel data display (AltF10)
  825.      Right panel data display (AltF10)
  826.  
  827. The setup file, DV.INI, is always kept in DV.EXE's home directory.
  828.  
  829.                                     EDITOR (8)
  830.  ==============================================================================
  831.  
  832. INTERNAL EDITOR
  833. ===============
  834.  
  835. DOSview comes with its own internal editor.  This means that any time you
  836. press F4, by default, DOSview will instantly edit the file with its editor.
  837. Although the DOSview editor has its limitations, it also has some handy
  838. characteristics.  We'll try to list the advantages and disadvantages next:
  839.  
  840.  
  841. Advantages
  842. ----------
  843. o    Instantly available and always there when you need it (not necessarily
  844.      true of add-on external editors).
  845.  
  846. o    Line oriented blocking (many external editors, however, if they offer
  847.      blocking, will have more sophisticated blocking than line only).
  848.  
  849. o    Instant cut and paste line operation (F3 and F4).
  850.  
  851. o    Built-in ascii chart.
  852.  
  853. o    Rudimentary printing capability.
  854.  
  855. o    Word wrap, justification, case ops, shift ops, tab options, and white
  856.      space display options.
  857.  
  858. o    Secondary WordStar commands key set.
  859.  
  860. o    Automatic editing of readonly files, restoring that attribute upon
  861.      completion of editing.
  862.  
  863. o    Clean editing format, i.e., closes the file while it is being edited to
  864.      make life easier on a network.
  865.  
  866.  
  867. Disadvantages
  868. -------------
  869. o    Text file editing only.
  870.  
  871. o    Files of 65519 bytes or less.
  872.  
  873. o    Line length of 127 characters or less.
  874.  
  875.  
  876. What's nice about the internal editor is that you can have it when you want it
  877. and still use your own favorite external editor when you wish.  See more about
  878. editing choices in the Setup section.
  879.  
  880. We think the DOSview internal editor is quite useful.  As meager as this
  881. documentation is -- it was done in its entirety with the DOSview editor.
  882.  
  883. Here are the internal editor commands by keys:
  884.  
  885.  
  886. Normal Function Keys
  887. --------------------
  888. F1   HELP      Context-sensitive help.
  889.  
  890. F2   SAVE      Saves the file being edited and continues editing.  (^KS)
  891.  
  892. F3   CUTB≈L    Cut either the current line or the current block (if a block is
  893.                highlighted) for later pasting.
  894.  
  895. F4   PUTB≈L    Pastes the last line or block that was cut.
  896.  
  897. F5   COPYB     Copies the marked block to the cursor position.  (^KC)
  898.  
  899. F6   MOVEB     Moves the marked block to the cursor position.  (^KV)
  900.  
  901. F7   BEGINB    Defines the beginning of a block.  (^KB)
  902.  
  903. F8   ENDB      Defines the end of a block.  (^KK)
  904.  
  905. F9   HIDEB     Toggles showing and hiding a marked block.  (^KH)
  906.  
  907. F10  QUIT      Quits editing the file.
  908.  
  909.  
  910. Alternate, Shift and Control Function Keys
  911. ------------------------------------------
  912. F1   CHART     Displays an ascii chart.
  913.  
  914. F2   PRNTB≈F   Prints the highlighted block or the entire file to LPT 1, 2 or
  915.                3. (^KP)
  916.  
  917. F3   DELEB≈L   Deletes the current block or line.  (^KY)
  918.  
  919. F4   CASEB≈L   Cases the current block or line to upper or lower case or
  920.                toggle the case.  (AltU, I, O)
  921.  
  922. F5   WRITEB    Writes the current block to a file.  (^KW)
  923.  
  924. F6   READB     Reads a file into a block.  (^KR)
  925.  
  926. F7   JUSTB≈L   Justifies the current block or line left, right or center with
  927.                the current margins.  (AltL, C, R)
  928.  
  929. F8   SHFTB≈L   Shifts the current block one character space to the left or
  930.                right.  (Alt-, =)
  931.  
  932. F9   TABB≈L    Entabs (adds tabs) or detabs (deletes tabs) to or from the
  933.                current block or line.  Entabbing makes tab characters out of
  934.                every eight space string.  Detabbing makes eight spaces out of
  935.                every tab.  (AltD, E)
  936.  
  937. F10  DISPLAY   Shows all file parts separate from non-file parts.  Great way
  938.                to find extra spaces at the end of lines.  Also toggles between
  939.                showing actual control characters and an easier-to-identify
  940.                representation of them.  (^OD)
  941.  
  942.  
  943. Miscellaneous Keys
  944. ------------------
  945. Ins            Toggles insert/overtype modes.  (^V)
  946.  
  947. Del            Deletes character at the cursor.  (^G)
  948.  
  949. ^T             Deletes word.
  950.  
  951. ^BkSp          Deletes word left.  (^H)
  952.  
  953. ^Y             Deletes current line.
  954.  
  955. ^QY            Deletes line right.  (AltK)
  956.  
  957. ^QL            Restores current line.  (^U)
  958.  
  959. ^OR            Sets right margin.
  960.  
  961. ^OI            Toggles auto indent mode.
  962.  
  963. ^OT            Toggles tab size between 8 and 5 characters.
  964.  
  965. ^OW            Toggles word wrap mode.
  966.  
  967. ^B             Reformats the current paragraph from the cursor position to the
  968.                end of the paragraph.
  969.  
  970. ^OB            Reformats the entire document from the cursor position.
  971.  
  972. ^P             Enters a control character with the next character typed.  To
  973.                enter an Escape character, press ^P and then Escape.
  974.  
  975. ^QF            Finds case insensitive.  (^Z)
  976.  
  977. ^QA            Finds and replaces.  The replace string is always case
  978.                sensitive.  (^A)
  979.  
  980. ^L             Does the next find or replace.  (AltZ or ShiftTab)
  981.  
  982. ^QQ            Enter the current date and time. (AltQ)
  983.  
  984. ^K1..3         Define a text marker.
  985.  
  986. ^Q1..3         Go to a text marker.
  987.  
  988.  
  989. Movement Keys
  990. -------------
  991. Arrows         One place in arrow direction.
  992.  
  993. Home           To beginning of line.
  994.  
  995. End            To end of line.
  996.  
  997. PgUp           Up one screen.
  998.  
  999. PgDn           Down one screen.
  1000.  
  1001. ^Home          To top of screen.
  1002.  
  1003. ^End           To bottom of screen.
  1004.  
  1005. ^PgUp          To top of file.
  1006.  
  1007. ^PgDn          To bottom of file.
  1008.  
  1009.  
  1010. Status Line Symbols
  1011. -------------------
  1012. The status line at the top of the editing screen is defined like this:
  1013.  
  1014. *FILENAME.EXT XX% Blk Ins Ind Tab:X Wrp:XX Row:XXXX Col:XXX Chr:XXX KB:XXX HH:MM
  1015.  
  1016. *              File has been modified and not yet saved.
  1017.  
  1018. FILENAME.EXT   The name of the file being edited.
  1019.  
  1020. XX%            Cursor placement in the file as a percentage of 100%.
  1021.  
  1022. Blk            A block is marked and showing.
  1023.  
  1024. Ins            Insert mode selected (vs overtype mode).
  1025.  
  1026. Ind            Auto indent mode selected.
  1027.  
  1028. Tab:X          Tab size is X (5, 8).
  1029.  
  1030. Wrp:XX         Right margin is XX (28 - 78).
  1031.  
  1032. Row:XXXX       Row is XXXX (1 - 9999).
  1033.  
  1034. Col:XXX        Column is XXX (1 - 127).
  1035.  
  1036. Chr:XXX        Character at cursor is code XXX (0 - 255).
  1037.  
  1038. Bytes:XXXXX    File is XXXXX Bytes in size (0 - 65519).
  1039.  
  1040.  
  1041. Editor Notes
  1042. ------------
  1043. All switches and states (word wrap, last find string, etc) are remembered
  1044. between editing sessions as long as DOSview remains active.
  1045.  
  1046. The F3 and F4 keys (cut and paste) actually write, read and erase a temporary
  1047. block on disk.
  1048.  
  1049. Most commands move the cursor down one line after completion to make
  1050. repetitive editing operations easier.
  1051.  
  1052. The word wrap function offers an extra feature not found in a lot of editors
  1053. or word processors.  When wrapping a paragraph, it respects the correctness of
  1054. two following spaces after sentence endings.  A sentence ending is defined by
  1055. a '.', '?', '!' or ':'.  In fact, it checks lines to make sure this is the
  1056. case, and if it finds an incorrect instance, it corrects it during the wrap.
  1057.  
  1058.  
  1059. INTERNAL VIEWER
  1060. ===============
  1061.  
  1062. DOSview comes with its own internal viewer.  This means that any time you
  1063. press F3, by default, DOSview will instantly view the file with its viewer,
  1064. unless, of course, an 'ext' program has been defined.  The DOSview viewer is
  1065. quite weak and is only available in case a defined external viewer is not
  1066. available.  It is only meant for text files and is actually a read-only
  1067. implementation of the editor.
  1068.  
  1069.  
  1070. Advantages
  1071. ----------
  1072. o    The viewer is available in case you have nothing else to use.
  1073.  
  1074.  
  1075. Disadvantages
  1076. -------------
  1077. o    Text file viewing only.
  1078.  
  1079. o    Files larger than 64K will only display the first 64K.
  1080.  
  1081. o    Line length of 254 characters or less.
  1082.  
  1083.  
  1084. See more about viewing choices in the Setup section.
  1085.  
  1086. Here are the internal viewer commands by keys:
  1087.  
  1088.  
  1089. Normal Function Keys
  1090. --------------------
  1091. F1   HELP      Context-sensitive help.
  1092.  
  1093. F10  QUIT      Quits editing the file.
  1094.  
  1095.  
  1096. Alternate, Shift and Control Function Keys
  1097. ------------------------------------------
  1098. F10  DISPLAY   Shows all file parts separate from non-file parts.  Great way
  1099.                to find extra spaces at the end of lines.  Also toggles between
  1100.                showing actual control characters and an easier-to-identify
  1101.                representation of them.  (^OD)
  1102.  
  1103.  
  1104. Miscellaneous Keys
  1105. ------------------
  1106. ^QF            Finds case insensitive.  (^Z)
  1107.  
  1108. ^L             Does the next find.  (AltZ or ShiftTab)
  1109.  
  1110.  
  1111. Movement Keys
  1112. -------------
  1113. Arrows         One place in arrow direction.
  1114.  
  1115. Home           To beginning of line.
  1116.  
  1117. End            To end of line.
  1118.  
  1119. PgUp           Up one screen.
  1120.  
  1121. PgDn           Down one screen.
  1122.  
  1123. ^Home          To top of screen.
  1124.  
  1125. ^End           To bottom of screen.
  1126.  
  1127. ^PgUp          To top of file.
  1128.  
  1129. ^PgDn          To bottom of file.
  1130.  
  1131.  
  1132. Status Line Symbols
  1133. -------------------
  1134. The status line at the top of the editing screen is defined like this:
  1135.  
  1136.  FILENAME.EXT                              Row:XXXX Col:XXX Chr:XXX  View  HH:MM
  1137.  
  1138. FILENAME.EXT   The name of the file being viewed.
  1139.  
  1140. Row:XXXX       Row is XXXX (1 - 9999).
  1141.  
  1142. Col:XXX        Column is XXX (1 - 254).
  1143.  
  1144. Chr:XXX        Character at cursor is code XXX (0 - 255).
  1145.  
  1146. ViewOnly       Signifies read-only mode.
  1147.  
  1148.                                   PANEL MODE (9)
  1149.  ==============================================================================
  1150.  
  1151. Panel Mode is the normal DOSview interface.  Normally two panels are visible,
  1152. left and right.  They are also referred to as the current panel and the other
  1153. panel.  A panel shows a portion of the current drive for that panel.  It
  1154. follows that the current panel shows the current drive (and directory) while
  1155. the other panel shows its drive and directory (which may not be the current
  1156. place unless both panels show the same thing).
  1157.  
  1158. Where a panel resides is called its domain.  In other words, if the current
  1159. panel (the panel that has the wide bar highlight cursor) is showing the TOOLS
  1160. directory contents on drive C, then that panel's domain is C:\TOOLS (the
  1161. current directory if you were really in DOS).  It's really very intuitive.
  1162.  
  1163. The top of each panel shows its domain name.  The current panel shows its
  1164. domain name in reverse colors, while the other panel shows its domain name in
  1165. the normal panel window frame color.
  1166.  
  1167. Within each panel are listed the directories (first) and the files (second)
  1168. that are in that domain.  They may be sorted in almost any fashion.  They may
  1169. or may not be filtered.
  1170.  
  1171. A big difference is whether the panel is in Wide Mode or Snake Mode.
  1172.  
  1173.  
  1174. Wide Mode
  1175. ---------
  1176. This is the alternate "picture" for a panel.  In this mode, each line includes
  1177. a file or directory name and certain information about that file or directory.
  1178. The wide bar cursor covers the width of the panel.  The top line in the panel
  1179. shows the titles for each field in the panel.  One of the field's titles is
  1180. always off-color, denoting the current sort column.  The bottom line in the
  1181. panel shows the totals for files, file sizes and directories within the
  1182. panel's domain.  Note that when files are tagged, the file and size totals
  1183. change to the totals for the tagged files only (the color changes to that of a
  1184. tagged file to help you remember this).  Also available on this line is a 'H'
  1185. or 'R' denoting whether all hidden or readonly files or shown in a "ghost"
  1186. color via the ShiftF6 GHOST command toggle.  Additionally, files may be
  1187. colored differently if file colors are active (see the Setup section for more
  1188. on this).
  1189.  
  1190. The size column may be in bytes or kilobytes, depending on the status of the
  1191. AltF10 DATA command toggle.  The same is true for the last column, which will
  1192. show either the file time or the file attributes.  (This is true to an extent
  1193. in both Wide and Snake Modes).
  1194.  
  1195.  
  1196. Snake Mode
  1197. ----------
  1198. This is the default "picture" for a panel.  In this mode, each column (there
  1199. are three of them here) shows a continuing list of directory and file names
  1200. only from the previous column.  The information for each file is now shown on
  1201. the top line in the panel.  One of the information items will still be
  1202. off-color to denote the current panel sort key.  The bottom line in the panel
  1203. is the same as when in Wide Mode.
  1204.  
  1205.  
  1206. Command Line
  1207. ------------
  1208. These keys will manipulate the command line while in Panel Mode:
  1209.  
  1210. ^Left/^Right   Move left/right ONE character on the command line (Left/Right
  1211.                are used to move the wide bar cursor).
  1212.  
  1213. ^Home/^End     Move to the next WORD on the command line (Home/End are used
  1214.                to move the wide bar cursor).
  1215.  
  1216. ^E/^X          Use these keys to load the previous/next issued DOS
  1217.                command onto the command line (Up/Down are used to move the
  1218.                wide bar cursor).
  1219.  
  1220. ^BkSp/^T       Delete the previous/next word on the command line.
  1221.  
  1222.                                    DOS MODE (10)
  1223.  ==============================================================================
  1224.  
  1225. DOS Mode is the alternate DOSview interface.  When in Panel Mode, pressing F2
  1226. takes you to DOS Mode (removes the panels from view).  The purpose of DOS Mode
  1227. is really just to view the full DOS screen.  But while in this mode, the
  1228. command line is a little easier to use.  If you change directories and then
  1229. later change to Panel Mode with F2, the new current directory will become the
  1230. current panel's domain, as you would expect.  We use F2 a lot to see the DOS
  1231. screen and to sometimes enter complicated DOS commands and then press Up Arrow
  1232. to repeat or edit them.  That's why the toggle command is on such a choice
  1233. function key.
  1234.  
  1235. In DOS Mode these keystrokes are available:
  1236.  
  1237. Normal Function Keys
  1238. --------------------
  1239. F1   HELP      Mini-help.
  1240.  
  1241. F2   PANELS    Returns to Panel Mode.
  1242.  
  1243. F9   MENU      Brings up the DOSview menu.
  1244.  
  1245. F10  QUIT      Quits DOSview.
  1246.  
  1247.  
  1248. Control Function Keys
  1249. ---------------------
  1250. F1   PANEL <   Turns on the left panel.
  1251.  
  1252. F2   PANEL >   Turns on the right panel.
  1253.  
  1254. F4   STATUS    Shows the currnet machine status.
  1255.  
  1256.  
  1257. Miscellaneous Keys
  1258. ------------------
  1259. /              DOSview provides a complete hard disk tree facility for quickly
  1260.                moving to a particular directory (great for networks).  See the
  1261.                Tree Mode section for more.  (The DOS command line must be
  1262.                empty to perform this command.)
  1263.  
  1264. =              DOSview provides a built in menu for DOS commands that is
  1265.                completely definable by you.  See the Menu Mode section for
  1266.                more.  (The DOS command line must be empty to perform this
  1267.                command.)
  1268.  
  1269.  
  1270. Command Line
  1271. ------------
  1272. Up/Down        Use these keys to load the previous/next issued DOS
  1273.                command onto the command line.
  1274.  
  1275. Left/Right     Moves left/right on the command line.
  1276.  
  1277. ^Left/^Right   Moves left or right one word on the command line.
  1278.  
  1279. Home/End       Moves to the beginning/end of the command line.
  1280.  
  1281. ^BkSp/^T       Deletes the previous/next word on the command line.
  1282.  
  1283. Ins            Toggle insert/overtype modes.
  1284.  
  1285. Esc            Restores and edited command line to its original form or
  1286.                deletes a command line.
  1287.  
  1288.                                   TREE MODE (11)
  1289.  ==============================================================================
  1290.  
  1291. DOSview has a Tree Mode that has one singular purpose, to find and go to
  1292. directories quickly.  Our system has over 1700 directories on the main Novell
  1293. (tm) volume.  Trying to navigate to many or these directories, even from
  1294. within a DOSview panel, can be tedious.  However, a quick '/' press and a
  1295. quick F2 for find and then Enter works wonders.  All of the intermediary
  1296. directory reads needed to get to some deep directories is passed when using
  1297. the tree to go to the directory.  Once you try it, you'll see what we mean.
  1298. The Tree Mode commands are:
  1299.  
  1300.  
  1301. Function Keys
  1302. -------------
  1303. F1   HELP      Tree Mode help.
  1304.  
  1305. F2   FIND      This command brings up a dialog box asking for the name of the
  1306.                directory you are searching for.
  1307.  
  1308. F3   NEXT      After moving to a directory on the tree's pick list, press F3
  1309.                to move to the next occurrence of the directory name you are
  1310.                trying to find.
  1311.  
  1312. F5   BUILD     This command rebuilds the tree after you have changed your
  1313.                directory structure.
  1314.  
  1315. F10  CANCEL    This command quits Tree Mode.  Pressing Enter on a directory
  1316.                will do the same thing, of course.
  1317.  
  1318.  
  1319. Notes
  1320. -----
  1321. After bringing up the tree, you can press the character keys to start an
  1322. incremental search.  For example, if you are looking for a directory named
  1323. TEMP, just start typing it:  T E M P.  DOSview will take you to that directory
  1324. name (if it is in the list) and then just press Enter to go to the directory
  1325. TEMP.
  1326.  
  1327. The tree file, DV.TRE, is always kept in the root directory of DV.EXE's home
  1328. drive in readonly, hidden status (DOSview's internal editor can edit readonly
  1329. files).
  1330.  
  1331. When attempting to build the tree file, DOSview always checks to see if it is
  1332. possible (you have rights to that root directory, etc.) before actually
  1333. starting the rebuild.
  1334.  
  1335. If you select a subdirectory starting with the same name as a sibling
  1336. subdirectory under the same parent directory, DOSview may be unable to locate
  1337. it.  For example, in this tree segment:
  1338.  
  1339.   ├PARENT
  1340.   │├SUB
  1341.   │└SUB2
  1342.  
  1343. if you select SUB2, DOSview will probably report it as missing.
  1344.  
  1345.                                 DOS MENU MODE (12)
  1346.  ==============================================================================
  1347.  
  1348. DOSview has a built-in menuing capability.  Probably the easiest way to
  1349. describe this is make a menu item and run it.
  1350.  
  1351. So..  press '=' to bring up the menu.  At first their will be nothing on the
  1352. list.  Press F2 to edit the list.  Then, as an example, enter D on the first
  1353. line.  Then press the Space Bar once.  Then enter Dir on the first line.  Then
  1354. tab once and enter the '|' (pipe) symbol.  Then enter DIR/W.  Then press Enter
  1355. to go to the next line.  Now press F2 to save the menu file.  Then press F10
  1356. to quit the editing mode (the menu is simply a text file held in the internal
  1357. editor).  Now press Enter while pointing to your Dir menu command.  That's all
  1358. there is to it.  You can have a near unlimited number of items in this list.
  1359. Any typeable character can be used as the menu character (case is sensitive
  1360. here).
  1361.  
  1362. If you wish for DOSview to prompt you for input, place a '?' after the
  1363. command.  Then, when running that command, DOSview will ask you for optional
  1364. parameters.  You may type in the parameter or press ^Enter to insert either
  1365. the highlighted file or all of the tagged files (if less than 127 characters)
  1366. into the DOS command.  When editing the menu file, press F1 for a reasonable
  1367. display of how to enter a menu item (as we just did above).  Placing a '!'
  1368. after the command will cause DOSview to automatically use the highlighted file
  1369. as the parameter.
  1370.  
  1371.  
  1372. Function Keys (when using the menu)
  1373. -------------
  1374. F1   HELP      Help.
  1375.  
  1376. F2   EDIT      Edits the menu file.
  1377.  
  1378. F10  CANCEL    Quits Menu Mode.
  1379.  
  1380.  
  1381. Function Keys (when editing the menu)
  1382. -------------
  1383. F1   HELP      Help (same as editor help).
  1384.  
  1385. F2   SAVE      Saves the menu file.
  1386.  
  1387. F3   CUTLN     Cuts the current line to a buffer.
  1388.  
  1389. F4   PUTLN     Puts the line from the buffer to the cursor position.
  1390.  
  1391. F10  QUIT      Quits editing.
  1392.  
  1393.  
  1394. Notes
  1395. -----
  1396. The menu file, DV.MNU, is always kept in DV.EXE's home directory in readonly,
  1397. hidden status (DOSview's internal editor can edit readonly files).
  1398.  
  1399. Note that when editing the menu file, you are actually in DOSview's internal
  1400. editor with a different window size.  All internal editor functions work
  1401. normally.  Also, F1 gives a good example of how to enter a new menu item.
  1402.  
  1403. Menu editing is only allowed when you are in Panel Mode.
  1404.  
  1405.                                    TAGGING (13)
  1406.  ==============================================================================
  1407.  
  1408. There is more than one way to tag a file or group of files in DOSview.  The
  1409. quickest and most used way is to use the Ins key to toggle the tag on the
  1410. currently highlighted file to on or off.
  1411.  
  1412. Note that when you tag files, the bottom line in the panel window changes to
  1413. the tagged color and now displays file and size totals for the tagged files
  1414. only.
  1415.  
  1416. Another way to tag files is to use the '+' key (either one) for tagging and
  1417. the '-' key for untagging.  When using either of these keys, you will be asked
  1418. for a file specification.  You may use any true DOS wild card spec here
  1419. (unlike some other areas of DOSview) to determine which files are to be tagged
  1420. or untagged.  When tagging a large set of files, this process can take a few
  1421. seconds or sometimes moments (unless the spec is *.*) as DOSview rereads the
  1422. domain and matches the appropriate file names.
  1423.  
  1424. This +, - tagging is progressive.  In other words you may decide to tag *.EXE
  1425. files and then tag *.COM files.  The *.EXE set will remain tagged as the *.COM
  1426. files become tagged.  The reverse (untagging) works the same way.
  1427.  
  1428.                                   BATCH MODE (14)
  1429.  ==============================================================================
  1430.  
  1431. The ShiftF8 BATCH command is available to help you perform batch operations on
  1432. defined groups of files in the current panel's domain.  After tagging the
  1433. files you wish to manipulate, press this command key and a dialog box will
  1434. appear.  Here are the dialog questions:
  1435.  
  1436. File name      Enter the name of the batch file you wish to make or run here.
  1437. ---------      The default is always ~DV.BAT.  If you do not change this name,
  1438.                then when you are ready to execute the information you have
  1439.                entered into the dialog box, DOSview will immediately run this
  1440.                batch file but will _not_ save it.  This is to keep you from
  1441.                trashing up your hard disk with many temporary batch files.
  1442.                You will need to rename this default name to something else,
  1443.                like MY.BAT, in order to save it.  Then DOSview will
  1444.                immediately save the file but not run it.  You must then point
  1445.                to it and run it or enter its name on the command line.  This
  1446.                is so you can review and perhaps edit the batch file before
  1447.                executing it.  You can also name the file by an ordinary name
  1448.                like MYLIST as opposed to a batch file name (.BAT).  This can
  1449.                be extremely useful for those programs (like PKZIP (tm)) that
  1450.                can use a list file full of file names derivatives.
  1451.  
  1452. Text before    Enter any text you wish to place before each file listed (the
  1453. -----------    tagged files) in the batch/list file.
  1454.  
  1455. Format For     Here, you have three choices on how DOSview will actually write
  1456. ----------     the tagged file names to the file.
  1457.  
  1458.                P = the full pathname, like C:\TOOLS\MY.EXE;
  1459.                F = the filename and extension only, like MY.EXE; and
  1460.                N = the filename only, like MY.
  1461.  
  1462. Text after     Enter any text you wish to place after each file listed (tagged
  1463. ----------     files) in the batch/list file.
  1464.  
  1465. Note that the bottom line in the dialog box always shows you exactly the line
  1466. you are building with the above entries.
  1467.  
  1468. BATCH FILE example:
  1469. If you enter
  1470.  
  1471. MY.BAT
  1472. copy
  1473. N
  1474. B: /v
  1475.  
  1476. then DOSview would make this batch file:
  1477.  
  1478. copy FILEX.EXT   B: /v
  1479. copy FILEXX.EXT  B: /v
  1480. copy FILEXXX.EXT B: /v
  1481. etc..
  1482.  
  1483. where FILEX.EXT represents the files you have tagged prior to entering the
  1484. dialog box.
  1485.  
  1486.  
  1487. LIST FILE example:
  1488.  
  1489. If you enter
  1490. MYLIST
  1491.  
  1492. F
  1493.  
  1494.  
  1495. then DOSview would make this list file:
  1496. FILEX.EXT
  1497. FILEXX.EXT
  1498. FILEXXX.EXT
  1499. etc..
  1500.  
  1501. Here, you could then issue this command on the DOS command line:
  1502.  
  1503. PKZIP -U @MYLIST
  1504.  
  1505. instead of
  1506.  
  1507. PKZIP -U FILE1.EXT FILE2.EXT FILE3.EXT etc.
  1508.  
  1509.                               NETWORK OPERATIONS (15)
  1510.  ==============================================================================
  1511.  
  1512. Operating DOSview on a network is exactly like operating it on a standalone
  1513. machine with the following exception.
  1514.  
  1515. You _may_ configure DOSview so that each user gets their own DV.INI file.
  1516. Simply make a file that resides in DV.EXE's home directory called DV.NET (or
  1517. NEWNAME.NET if you renamed DV.EXE).  Place the path for users' ini files on
  1518. the first line of this file, like H:\.  All users must have acess rights to
  1519. this path and it must be a place that is physically distinct for all users.  A
  1520. "privately" mapped "home" drive is perfect in this case, like mapping
  1521. F:\USER\%USERNAME% to H:\.
  1522.  
  1523. In the above case, when a user starts DOSview for the first time, DOSview will
  1524. copy a DV.INI file from DV.EXE's home to the path defined in DV.NET.  It will
  1525. only do that if DV.INI is not already there.  From then on, the user has his
  1526. own INI file.
  1527.  
  1528.                                    CREDITS (16)
  1529.  ==============================================================================
  1530.  
  1531. Norton Commander and Norton Utilities are trademarks of Symantec Corporation.
  1532.  
  1533. Turbo Pascal is a trademark of Borland International.
  1534.  
  1535. PKZIP is a registered trademark of PKWARE, Inc.
  1536.  
  1537. MS-DOS is a trademark of Microsoft Corporation.
  1538.  
  1539. Netware and Novell are registered trademarks of Novell, Inc.
  1540.  
  1541. Trademarks of other companies mentioned in this file are the property of their
  1542. respective companies.
  1543.  
  1544.                                   SHAREWARE (17)
  1545.  ==============================================================================
  1546.  
  1547. Shareware
  1548. ---------
  1549. THIS IS NOT FREE SOFTWARE!  You may evaluate and use this product, but if you
  1550. decide to make use of it on a regular basis, you should register your copy.
  1551.  
  1552. Note:  Businesses, government agencies and institutions are required to
  1553. register this software package before extended use.
  1554.  
  1555. We offer several inducements to you for registering.  First of all, you will
  1556. receive the most up-to-date copy of the program that we have -- and we update
  1557. the program on a regular basis.  Also, we have a few utilities that work quite
  1558. nicely with DOSview (multi-windowed editor, Norton Utilites (tm) -like mini
  1559. clone, etc.) not included in this package that we will ship to you upon
  1560. registration.  Third, you will never see the shareware message again.  Make no
  1561. mistake, however -- this is a fully functional version of DOSview that is not
  1562. "crippled" in any way (other than the shareware notice when requesting help).
  1563.  
  1564.  
  1565. Distribution
  1566. ------------
  1567. This is "user-supported" software.  You are hereby granted permission to
  1568. distribute this evaluation copy of DOSview and its documentation, subject to
  1569. the following conditions:
  1570.  
  1571. 1.  DOSview may be distributed freely without charge in evaluation form only.
  1572.  
  1573. 2.  DOSview may not be sold, licensed, or a fee charged for its use.  If a fee
  1574.     is charged in connection with DOSview, it must cover the cost of copying
  1575.     or dissemination only.  Such charges must be clearly identified as such by
  1576.     the originating party.  Under no circumstances may the purchaser be given
  1577.     the impression that he is buying DOSview itself.
  1578.  
  1579. 3.  DOSview must be presented as a complete unit, including this
  1580.     documentation.  Neither DOSview nor its documentation may be amended or
  1581.     altered in any way.
  1582.  
  1583. 4.  By granting you the right to distribute the evaluation form of DOSview,
  1584.     you do not become the owner of DOSview in any form.
  1585.  
  1586. Any other use, distribution or representation of DOSview is expressly
  1587. forbidden without the written consent from the author.
  1588.  
  1589.  
  1590. Registration
  1591. ------------
  1592. The non-commercial single-user registration fee for DOSview is $25.00 US.  
  1593. The commercial/government and multi-system site fee for DOSview is $100.00 US.
  1594.  
  1595. Send a check, money order or company P.O. for the appropriate amount to:
  1596.  
  1597.           Skip Bremer - DOSview
  1598.           3401 Cactus Wren Way
  1599.           Austin, Texas 78746
  1600.  
  1601. Thank you.
  1602.  
  1603.  
  1604. Disclaimer
  1605. ----------
  1606. The author does not warrant that the functions contained in this program will
  1607. meet your requirements or that the program operation will be uninterrupted or
  1608. error free.
  1609.  
  1610. The author specifically disclaims all other warranties, expressed or implied,
  1611. including but not limited to implied warranties of fitness for any particular
  1612. purpose and of merchantability.
  1613.  
  1614. In no event will the author be liable to you for any damages, including but
  1615. not limited to any lost profits, lost savings, commercial damage or other
  1616. incidental or consequential damages arising out of the use or inability to use
  1617. this program, or for any claim by any other party.
  1618.